home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / renamehost.z / renamehost
Encoding:
Text File  |  1998-10-20  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. RRRREEEENNNNAAAAMMMMEEEEHHHHOOOOSSSSTTTT((((3333NNNN))))                                                  RRRREEEENNNNAAAAMMMMEEEEHHHHOOOOSSSSTTTT((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      renamehost - rename the existing hostname in NIS hosts database
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnntttt rrrreeeennnnaaaammmmeeeehhhhoooosssstttt((((cccchhhhaaaarrrr ****oooollllddddnnnnaaaammmmeeee,,,, cccchhhhaaaarrrr ****nnnneeeewwwwnnnnaaaammmmeeee,,,, cccchhhhaaaarrrr ****aaaalllliiiiaaaasssseeeessss,,,,
  13.                cccchhhhaaaarrrr ****ppppaaaasssssssswwwwdddd))));;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      RRRReeeennnnaaaammmmeeeehhhhoooosssstttt sends an host rename request to _r_e_g_i_s_t_r_a_r(_1_M) on NIS master
  17.      via the _y_p__u_p_d_a_t_e(_3_R) call.  The result is that the new host name will be
  18.      associated with the original internet address.  This routine should be
  19.      used only when NIS is enabled in the network.  This function call can not
  20.      only change the hostname, but also modify the aliases.
  21.  
  22.      The arguments for the routine are:
  23.  
  24.           oooollllddddnnnnaaaammmmeeee
  25.                The original host name.
  26.  
  27.           nnnneeeewwwwnnnnaaaammmmeeee
  28.                The new host name for the internet address.  This new name
  29.                should not be already used by other host.  However, it can be
  30.                the alias of the original host.  User may want to use this call
  31.                to swap the alias and host name.  User also can use this call
  32.                just to modify the alias when _n_e_w_n_a_m_e is the same as _o_l_d_n_a_m_e.
  33.  
  34.           aaaalllliiiiaaaasssseeeessss
  35.                The new aliases, each separated by spaces, of the host. The
  36.                maximum number of characters allowed in the string is
  37.                MAX_ALIASES defined in <sun/hostreg.h>.  The new aliases can be
  38.                the same as the original aliases, or contains the old host
  39.                name.  A NULL indicates the alias is omitted.
  40.  
  41.           ppppaaaasssssssswwwwdddd
  42.                The root password of NIS master. If NIS master does not have
  43.                root password, simply pass a NULL.
  44.  
  45.      On successful completion, RRRReeeennnnaaaammmmeeeehhhhoooosssstttt returns NULL.  The unsuccessful
  46.      return code are defined in <rpcsvc/ypclnt.h>.
  47.  
  48.      RRRReeeennnnaaaammmmeeeehhhhoooosssstttt always wait until NIS databases are pushed to all slave
  49.      servers.
  50.  
  51. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.      registrar(1M), yp_update(1M), registerinethost(3N), unregisterhost(3N),
  53.      yppush(1M)
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.